home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / dice360.arc / DICE.DOC next >
Encoding:
Text File  |  1987-05-15  |  10.2 KB  |  264 lines
  1. DICE.EXE - DOS Interactive Command Editor version 3.6           Page 1
  2.  
  3.  
  4.                           TABLE OF CONTENTS
  5.  
  6.         1       INTRODUCTION . . . . . . . . . . . . . . . . . . . . 1
  7.         2       OPERATION  . . . . . . . . . . . . . . . . . . . . . 1
  8.         2.1       Command Prompt . . . . . . . . . . . . . . . . . . 2
  9.         2.2       Command Line And Buffer Editing  . . . . . . . . . 2
  10.         2.3       DICE.EXE Function Key Definitions. . . . . . . . . 3
  11.         2.4       Restrictions . . . . . . . . . . . . . . . . . . . 4
  12.         3       PROGRAM AND DOCUMENTATION USAGE  . . . . . . . . . . 5
  13.  
  14.  
  15.  
  16.    Copyright (C) 1986 Eric S. Adams
  17.  
  18.  
  19.  
  20.  
  21. 1  INTRODUCTION
  22.  
  23.      DICE.EXE (DOS Interactive Command Editor) is a DOS command editor
  24. which enables more efficient entry of DOS commands.  It features:
  25.  
  26.      1.  Enhanced editing capability of DOS command line.
  27.      2.  Stacks 20 previously entered DOS commands for recall  to  the
  28.          command line.
  29.      3.  Stores 10 commands which  can  be  edited,  displayed  and/or
  30.          executed in a menu like fashion.
  31.      4.  Provides 3 undelete buffers which can be used to hold command
  32.          parameters.
  33.      5.  Display of saved commands, stacked commands and buffers.
  34.      6.  Buffer can be stored in a  disk  file  to  be  read  in  when
  35.          DICE.EXE is started.
  36.      7.  Help function that shows a summary of DICE.EXE commands.
  37.  
  38.  
  39.  
  40.  
  41. 2  OPERATION
  42.  
  43.      After DICE.EXE is invoked, command entry is much like that of DOS
  44. with the the added features listed above.
  45.  
  46.      At startup time it attempts to read the file  DICE.DAT  from  the
  47. current directory.  This file contains the contents of the command and
  48. undelete buffers and can be created from DICE.EXE by pressing <alt>F1.
  49. If  the  file  does  not  exist, the buffers are left empty.  If a $Cn
  50. switch has been specified as a command parameter, then  DICE.EXE  will
  51. execute the command stored in the saved command buffer n.  See example
  52. below.
  53.  
  54.      If DICE.EXE waits for a key for about 20 minutes or so,  it  will
  55. clear  the  screen.   It  does  this  by  clearing  display page 3 and
  56. selecting it.  When a key is pressed, then the  display  is  restored.
  57. Note,  the  screen  is  not  cleared from within applications run from
  58. DICE.
  59. DICE.EXE - DOS Interactive Command Editor version 3.6           Page 2
  60.  
  61.  
  62. 2.1  Command Prompt
  63.  
  64.      DICE.EXE generates it's own command prompt which is configured by
  65. specifying  command  arguments  when  the  program  is  invoked.   The
  66. DICE.EXE command arguments are as follows:
  67.  
  68.      1.  $nnn - display attribute of  the  prompt,  command  line  and
  69.          DICE.EXE displays.
  70.      2.  $$ - puts a dollar sign in the prompt string.
  71.      3.  $d - puts the current date in the prompt string.
  72.      4.  $t - puts the time of day into the prompt.
  73.      5.  $p - puts the current drive and directory into the prompt.
  74.      6.  $_ - does a carriage return/line feed.
  75.      7.  $v - inserts the DOS version number into the prompt.
  76.      8.  $g - puts in the ">" character.
  77.      9.  $l - puts in the "<" character.
  78.     10.  n - puts in the drive letter.
  79.     11.  $Cn -  executes  saved  command  buffer  n  upon  startup  of
  80.          DICE.EXE.
  81.     12.  ASCII characters go into the prompt string unaltered with the
  82.          exception of excess white space which gets ignored.
  83.  
  84.  
  85.      For example, if DICE.EXE is invoked as follows:
  86.  
  87. EXAMPLE:    DICE.EXE $C10 $10 $d $t $p $_Ready$g
  88.  
  89. The command in saved command  buffer  10  will  be  executed  and  the
  90. display  will  be  in light green (CGA).  The prompt for command entry
  91. format will be as follows:
  92.  
  93. Wed, Oct 1,1986  2:00:30.01pm  C:\COMM
  94. Ready>_
  95.  
  96.  
  97.  
  98.  
  99. 2.2  Command Line And Buffer Editing
  100.  
  101.      The following list  summarizes  the  editing  functions  for  the
  102. command buffers:
  103.      1.  Left arrow - moves cursor left one character.
  104.      2.  <Ctrl> Left arrow - moves cursor left one word.
  105.      3.  Right arrow - moves cursor right one character.
  106.      4.  <Ctrl> Right arrow - moves cursor right one word.
  107.      5.  Home - moves to the start of the command line.
  108.      6.  End - moves to the end of the command line.
  109.      7.  Up arrow - moves saved command pointer up one command.
  110.      8.  PgUp - moves command pointer to the saved command section.
  111.      9.  Down arrow - moves saved command pointer down one command.
  112.     10.  PgDn - moves the command pointer down to  the  command  stack
  113.          and sets the command stack to the bottom.
  114.     11.  <Ctrl>PgUp - scrolls up 5 commands in the command stack.
  115.     12.  <Ctrl>PgDn - scrolls down 5 commands in the command stack.
  116.     13.  <Esc><Esc> - exits from DICE.EXE and returns  to  normal  DOS
  117.          operation.
  118. DICE.EXE - DOS Interactive Command Editor version 3.6           Page 3
  119.  
  120.  
  121.     14.  Del - deletes the character under the cursor  and  pushes  it
  122.          onto  the  delete character garbage stack as well as into the
  123.          undelete character buffer.
  124.     15.  Backspace - deletes  the  character  before  the  cursor  and
  125.          pushes it onto the backspace delete character garbage stack.
  126.     16.  Ins  -  toggles  the  edit  mode  between  insert  mode   and
  127.          overstrike mode.
  128.     17.  A Semi-colon is a command line delimiter and can be  used  to
  129.          include comments in the saved command buffers.  For example:
  130.  
  131.             CD C:\MYDIR         ; Change to my directory
  132.  
  133.     18.  A comma is a  command  delimiter  and  can  be  used  to  put
  134.          multiple commands on a single command line.  For example:
  135.  
  136.             C:,CD C:\MYDIR       ; go to drive c and change to my directory
  137.  
  138.  
  139.  
  140.  
  141.  
  142. 2.3  DICE.EXE Function Key Definitions.
  143.  
  144.      The function keys F1 through F10 perform the following functions.
  145.  
  146.        +---------------+---------------+
  147.        |F1             |F2             |
  148.        |  DICE HELP    |  DICE DISPLAY |
  149.        |               |               |
  150.        |               |               |
  151.        +---------------+---------------+
  152.        |F3             |F4             |
  153.        |  TOGGLE LAST  |   TOGGLE      |
  154.        |  COMMAND ON   |   TO AND FROM |
  155.        |  COMMAND LINE |   EDIT MODE   |
  156.        |               |               |
  157.        +---------------+---------------+
  158.        |F5             |F6             |
  159.        |  DELETE TO    |  UNDELETE     |
  160.        |  END OF LINE  |  LAST END OF  |
  161.        |               |  LINE DELETE  |
  162.        |               |               |
  163.        +---------------+---------------+
  164.        |F7             |F8             |
  165.        |  DELETE WORD  |  UNDELETE     |
  166.        |  AND PUT IN   |  FROM WORD    |
  167.        |  WORD BUF. A  |  BUF. A       |
  168.        |               |               |
  169.        +---------------+---------------+
  170.        |F9             |F10            |
  171.        |  DELETE WORD  |  UNDELETE     |
  172.        |  AND PUT IN   |  FROM WORD    |
  173.        |  WORD BUF. B  |  BUF. B       |
  174.        |               |               |
  175.        +---------------+---------------+
  176.                                         
  177. DICE.EXE - DOS Interactive Command Editor version 3.6           Page 4
  178.  
  179.  
  180.      Alt.  Function key definitions:
  181.  
  182.        +---------------+---------------+
  183.        |Alt F1         |Alt F2         |
  184.        | STORE COMMAND | READ COMMAND  |
  185.        | STACK IN FILE | STACK FROM    |
  186.        | DICE.DAT      | FILE DICE.DAT |
  187.        |               |               |
  188.        +---------------+---------------+
  189.        |Alt F3         |Alt F4         |
  190.        |               |               |
  191.        |               | Undelete      |
  192.        |               | Character     |
  193.        |               |               |
  194.        |               |               |
  195.        +---------------+---------------+
  196.        |Alt F5         |Alt F6         |
  197.        |               |               |
  198.        |               | Pop Del       |
  199.        |               | Character     |
  200.        |               | Garbage       |
  201.        |               |               |
  202.        +---------------+---------------+
  203.        |Alt F7         |Alt F8         |
  204.        |               |               |
  205.        |               |  Pop          |
  206.        |               |  Backspace    |
  207.        |               |  Delete char. |
  208.        |               |  Garbage      |
  209.        +---------------+---------------+
  210.        |Alt F9         |Alt F10        |
  211.        |               |               |
  212.        |               |  Pop Word     |
  213.        |               |  Delete       |
  214.        |               |  Garbage      |
  215.        |               |               |
  216.        +---------------+---------------+
  217.  
  218.  
  219.      Shift function keys execute the  saved  commands.   For  example:
  220. Shift F1 will execute saved command number 1.
  221.  
  222.  
  223.  
  224. 2.4  Restrictions
  225.  
  226.      DICE.EXE uses the  DOS  int  21  EXEC  function  to  execute  DOS
  227. commands, batch jobs or run executable files.  This function brings in
  228. part of the DOS file command.com from disk and the current environment
  229. including the path.  This has the following affects:
  230.  
  231.      1.  Executing commands is slower.  This isn't too bad on  systems
  232.          with  a  bootable  hard  disc,  but can be annoying on floppy
  233.          based systems.
  234. DICE.EXE - DOS Interactive Command Editor version 3.6           Page 5
  235.  
  236.  
  237.      2.  The set and path commands only set the  environment  or  path
  238.          until  the  command  is finished, after which the environment
  239.          returns to what it was before the command.  If  you  use  the
  240.          set  or  path  functions in a batch job, it will remain until
  241.          the batch job is complete.  If you want to use set or path to
  242.          permanently   change  the  environment,  you  must  exit  the
  243.          DICE.EXE program.
  244.  
  245. DICE.EXE uses about 22k of memory.
  246.  
  247.  
  248.  
  249. 3  PROGRAM AND DOCUMENTATION USAGE
  250.  
  251.      The DICE.EXE program and documentation are intended to be  copied
  252. and/or distributed for non-commercial use.
  253.  
  254.      If you're using the DICE.EXE program and  find  it  useful  as  I
  255. have,  your contribution ($15 suggested) would be greatly appreciated.
  256. Also if you have comments or suggestions for the program, please  mail
  257. them and I'll consider them for future revisions.
  258.  
  259.    Eric S. Adams
  260.    29284 Willow Lane
  261.    Willoughby Hills, Ohio
  262.               44092
  263.  
  264.